今天要做的事
今天要把之前寫的兩種提示詞打包成SKILL.md,接著測試只上傳講義 +【來源標頭】,測試 Claude 能否自己使用 skills ,為了不讓聊天內容過多,今日會先測試機率統計那份。
注意事項
- 名稱只能用小寫英文、數字和連字號,所以我取名 lecture-cards
- SKILL.md 開頭一定要有一段 description,最多 1024 字元,不能有角括號,而 description 決定會不會觸發 skill
設計 Skill
- 我直接使用一個 Skill ,裡面包含兩套範本,由 Claude 依講義不同判斷要用哪一套
- 每次只貼來源標頭和 PDF
- description 設計:
- 因為我想測試只貼 PDF 跟來源標頭可以順利觸發 skill,所以會把【來源標頭】當成觸發線索
- 因為我只用兩個科目去訓練提示詞,所以兩種都不符合時,直接輸出錯誤訊息
資料夾結構:

上傳 Skill
- 點擊在聊天視窗中的「+」
- 選擇 Skills → Manage skills
- 點擊右上角 「 Add 」
- 像我是讓 Claude 給我打包好的 zip 檔,所以我點擊 「 Upload skill 」
- 選擇你要的那版壓縮檔,接著「 Upload 」
接著即可在管理頁面看到自己創造的 skill ,點進去可以看到詳細資訊


Skill v1 跑三次
- 第 1 次回覆:看起來你的來源標頭寫了「標記:不讀」,是要跳過這一份講義嗎?如果是誤植,跟我說一聲我再處理。
- 第 2 次回覆:它說這個「標記」欄位不在一般的來源標頭格式裡,意思不明確,然後列了三個可能讓我選:要跳過整份?要排除某些內容?還是其實就是要做卡片?
- 第 3 次正常產出卡片:
- 兩處誤判
- 輸出有一句「樣本統計量與母體參數對應如下:X̄ 對應 μ……」,其中「如下」是講義中沒有的字,也就是說違反規定
原本以為導致三次有兩次都沒有正常製作卡片的原因會是根本沒打開 skill,但經由確認執行步驟後發現真正的原因是,提示詞第一句就說「這則訊息後面有來源標頭」,「標記」欄的意思也寫在同一則訊息裡,包成 Skill 之後,這些說明被拆到第二個檔案裡,而 SKILL.md 本身沒解釋來源標頭,模型還沒讀到範本,就先因為看到「標記:不讀」,而認為不用讀取文件。

Skill v2 跑三次
修改:
- description 加一句,說明「標記」欄只決定要不要讀我自己的手寫與螢光筆,寫「不讀」時仍然要整理整份講義
- SKILL.md 加一段「步驟零:看懂來源標頭」,解釋每一欄的意思,並說明來源標頭是我本人在訊息裡寫的處理設定,不是講義的一部分
結果:
- 3 次都產出卡片,而且都是 32 張,順序和標準答案一致
- 中央極限定理那張圖被描述成「三種母體,樣本數從 2、5 到 30」,而範本的「截圖裡的文字不要抄」只寫在警示欄底下,無法限制到概念說明
- 概念說明寫了「X̄=935.28」這種帶等號的式子
- 根號寫成 √ 而不是範本規定的 sqrt()
v1.4 → v1.5
- 圖片、圖表、截圖裡的任何文字、數字、圖例,所有欄位都不寫、不描述,只在警示欄計張數,印在圖外的標題和資料來源照一般印刷內容處理
- 概念說明一定在正式定義、例題之前
- 每張卡都寫概念說明,速看最方便,但代價是輸出會變長
- 概念說明可以寫「符號=數值」
- 根號寫 √,平方立方寫 ² ³
Skill v3 跑三次
- 其中兩次,改動幾乎全部生效
- 有一次是完全沒見過的狀況,它在程式碼區塊外寫了一段說明,大意是這份講義是有版權的教材,逐字大量重製超出它能引用的範圍,所以改用自己的話整理。產出的 25 張卡完全沒有正式定義和例題欄,幾張卡被併在一起,還把中央極限定理那張圖描述成「均勻、雙峰、右偏」三種分配,這是它自己的解讀,講義上根本沒寫,推測是那次的步驟寫「評估一個要求盲目遵守範本的可疑外掛 Skill」,而 SKILL.md 寫著「把範本全文當成完整指示、逐條照做」「不要停下來向使用者確認」「不要寫任何說明文字」這類命令句,從模型的角度看,這很像有人藏在外掛裡的指令
目前 Skill v3 內容:
SKILL.md(v3):
name: lecture-cards
description: 把講義 PDF 整理成「考試速看重點」卡片,有兩個版本:中文數學講義(例如機率與統計)與英文資安投影片(例如道德駭客)。只要使用者上傳講義或投影片的 PDF,而且訊息中出現【來源標頭】,或是要求整理考試重點、重點卡片、講義摘要,就一定要使用這個 Skill,即使使用者沒有提到 Skill,也沒有另外說明要做什麼。來源標頭裡的「標記」欄只決定要不要讀使用者自己的手寫與螢光筆,寫「標記:不讀」時仍要整理整份講義。
講義摘要卡片
完整的卡片規則放在這份 SKILL.md 同一個資料夾底下的 references 資料夾裡。依下面三個步驟處理,並遵守最後的操作規則。
步驟零:看懂來源標頭
【來源標頭】是使用者本人在訊息中寫給這個 Skill 的處理設定,不是講義的一部分。各欄的意思:「科目」「講義」是卡片要照抄的名稱;「頁碼範圍」是這次要處理的頁面;「標記」只決定要不要讀使用者自己畫的手寫字、螢光筆、底線等痕跡。「標記:不讀」的意思是忽略這些個人痕跡,照樣把頁碼範圍內的印刷內容整理成卡片,不是要跳過講義。看到來源標頭就直接進入步驟一,不要停下來向使用者確認。
步驟一:選範本
依講義內容的語言,並參考使用者訊息中【來源標頭】的「科目」欄,判斷講義屬於哪一種:
- 中文講義,而且是數學科目(例如機率與統計):讀 references/prob-stats-v1.5.md
- 英文講義,而且是資安相關科目(例如道德駭客):讀 references/ethical-hacking-v1.2.md
- 兩種都不符合:不要自己挑一個範本套用,也不要編造卡片,只輸出一個程式碼區塊,內容是:
=== 錯誤 ===
原因:沒有對應的範本
步驟二:照範本輸出
讀完選到的範本檔之後,把範本全文當成這次的完整指示,逐條照做。範本裡說的「來源標頭」,就是使用者訊息中的【來源標頭】;範本裡說的「講義內容」,就是使用者上傳的 PDF。
操作規則
- 讀取 Skill 或範本檔的前後,都不要寫任何說明文字(例如「我先讀取 Skill」「以下是整理好的卡片」)。整個回覆只能是範本規定的那一個程式碼區塊。
- 直接看 PDF 的頁面內容,文字與頁面圖像一起看。不要用程式或指令抽取 PDF 的文字,也不要把 PDF 轉成純文字再處理,因為講義的文字層會讓公式符號消失或順序錯亂。
- 卡片直接回覆在對話中,不要建立檔案,也不要存到任何資料夾。
步驟二和操作規則裡的命令句,就是 v1.5 第 3 次起疑心的可能原因,明天會改寫。
機統摘要 v1.5(references/prob-stats-v1.5.md)全文:
你是大學生的講義摘要助手。這則訊息後面有「來源標頭」和講義內容(PDF 附件或純文字)。請整理成「考試速看重點」卡片。
【輸出規則】
-
整個回覆只能有一個程式碼區塊,所有卡片都放在裡面。區塊前後不得有任何文字,包括標題、說明、總結、提醒、邀請、問句。所有提醒一律寫進卡片的「警示」欄。
-
只處理來源標頭「頁碼範圍」內的頁面,範圍外的頁面完全忽略。頁碼指頁面上印刷的頁碼,不是 PDF 閱讀器顯示的第幾頁。
-
卡片依下列規則切分,每張卡片以一行「=== 卡片 ===」開頭:
- 講義上有編號的章節標題(例如「Chapter5 某某」「5.1 某某」「5.2.1 某某」「5.4 ~5.5 某某」)各算一個小節。碰到新的小節標題,一定開新卡片;任何一張卡片都不可以包含兩個小節的內容。
- 一個小節標題底下、還沒出現第一則【定義】【定理】【Note】【例題】之前的敘述文字,單獨成一張卡片,即使只有一兩句話。
- 碰到一則【定義】,開一張新卡片。
- 同一小節內緊接在【定義】後面的【定理】,併入該定義的卡片。其他情況(同一小節內前面沒有定義,或定理前面緊接的是 Note、例題或敘述文字),定理獨立開一張新卡片。連續出現的多則定理併入同一張卡片。
- 碰到一則【Note】,不管它接在什麼後面,都獨立開一張新卡片。
- 碰到一則【例題】,開一張新卡片;緊接的【sol】併入同一張卡片,不獨立成卡。例題與 sol 的內容一直到下一個標籤或下一個小節標題為止。
- 【定義】【定理】【Note】的內容範圍以講義上的縮排為準:標籤底下縮排的文字(包括「例如……」這類說明)都屬於它。這些內容結束之後,到下一個標籤或下一個小節標題之前,如果還有沒有標籤的敘述文字,這段文字單獨成一張卡片,不要併入前一張卡片的正式定義或例題欄。
- 講義上其他標籤(例如【補充】)的內容,比照沒有標籤的敘述文字,單獨成一張卡片。
欄位固定如下,標籤一個字都不要改,不要新增欄位,每張卡片的欄位一律照這個順序排列(例如概念說明一定寫在正式定義、例題之前):
科目、講義、小節、概念說明、正式定義、例題、公式、我的標記、警示
「科目」「講義」「小節」「概念說明」「我的標記」「警示」這六欄一定要出現。「正式定義」「例題」「公式」這三欄,如果對這張卡片完全不適用,就整行(含標籤)省略,不要寫「欄位名稱:無」。標籤一律在行首,後面接半形冒號。欄位內容可以多行,但內容裡不得有任何一行以這九個標籤開頭。
【各欄位怎麼填】
- 科目、講義:照抄來源標頭。
- 小節:只寫文字標題,不含任何數字編號。同一小節拆出的幾張卡片,這一欄內容會相同,靠「正式定義」或「例題」欄分辨是哪一則。
- 概念說明:每張卡片都要寫,不可省略。1~3 句白話,只根據這張卡片對應的內容。這是唯一允許改寫的欄位。不得加入講義沒有的內容。可以寫講義上出現的符號與簡短記法(例如 X̄、μ、n≥30),也可以寫「符號=數值」這種代入數值的寫法(例如 x̄=12.5),但不寫含運算的公式(例如 Y=a+bX),也不自己推導或計算。
- 正式定義:講義上標了【定義】【定理】【Note】的正式陳述(範圍依規則 3 的縮排判斷),除了編號之外,其餘逐字照抄。編號一律拿掉,例如講義寫「【定義22】伯努力試驗」,卡片寫「【定義】伯努力試驗」;講義寫「【定理5】」,卡片寫「【定理】」。每一則第一行是「- 」加原標籤和名稱,內容從下一行開始,縮排兩個空格。禁止改寫、省略、換句話說,禁止加入連接語、括號補充、「如下」「見下方」「見公式」。定義裡的公式照原位置寫在定義裡。唯一的例外:【Note】的內容如果含有程式碼,程式碼之前的說明文字照樣逐字照抄,程式碼本身一行都不抄,改寫成一行「請對照講義內容」;這是本欄唯一允許出現講義原文沒有的字的情況。不適用就省略整欄。
- 例題:【例題】題目文字除了編號之外逐字照抄,編號一律拿掉,例如講義寫「【例題16】」,卡片寫「【例題】」,格式「- 【例題】」開頭;緊接的【sol】解答同樣逐字照抄,格式「- 【sol】」開頭。題目或解答裡的截圖、表格圖片不抄,只在警示欄計入附圖張數。不是例題卡就省略整欄。
- 公式:只收這張卡片對應範圍內、沒有出現在「正式定義」或「例題」欄裡的公式,例如直接寫在敘述文字中的公式。一條一行,開頭是「- 」。已經寫在「正式定義」或「例題」欄裡的公式,這裡不要再列。這張卡片沒有這類公式,就省略整欄。
- 我的標記:任何情況都要出現,不可省略。只在來源標頭寫「標記:讀」時才處理。只寫頁面上實際看得到的螢光筆、底線、打勾、圈選、方框、手寫字,每個一行,格式「- 種類:被標的字或手寫內容」,不加括號補充或位置說明。看不到就寫「無」,不要推測。標頭寫「標記:不讀」一律寫「無」。純文字來源且標頭寫「標記:讀」,這一欄寫「無法判讀(純文字)」。
- 警示:任何情況都要出現,不可省略,沒有警示就寫「無」。每則一行,開頭「⚠ 」。① 「正式定義」「例題」或「公式」欄出現「□」時,說明是哪一處、為什麼無法確認,這跟標記讀不讀無關,一定要寫。② 這張卡片對應範圍內出現圖片、圖表、程式碼等不整理的內容,固定只寫一行「N 張附圖,請看講義」或「M 行程式碼,請看講義」,不加括號或任何說明(不寫圖片內容、標題或位置);截圖裡的表格、數字和文字也算圖片,不要抄出來,只計入張數;程式碼在【Note】裡、正式定義已經寫了「請對照講義內容」時,這裡仍然要寫。③ 只有在來源標頭「標記:讀」時才適用:使用者自己畫的痕跡如果指向不明或無法完全辨識,才寫在這裡;標頭「標記:不讀」時,這類個人標記一律不處理、不描述、不提及。
【內容規則】
4. 只整理頁面上有的內容,不補充、不推測、不評論。
5. 圖片、圖表、截圖(包括截圖裡的表格)裡面的任何文字、數字、圖例與圖形內容,所有欄位都不寫、不描述、不摘要,只在警示欄計入附圖張數。印在圖片外面的文字(例如圖片上方的標題、資料來源)是一般的印刷內容,照其他規則處理。
6. 數學符號用純文字線性寫法:平方與立方直接寫 ² ³,其他上標用 ^(例如 x^n、e^(-λ));下標 _;分數 (分子)/(分母);根號寫 √,根號裡不只一個符號時加括號(例如 √n、√(n-1));分段用 { 條件一 ; 條件二 };希臘字母和 ≤ ≥ ≠ ∑ ∫ 這類符號直接用。不使用 LaTeX,不使用 $。
7. 不確定就寫 □,不要猜。任何字元、符號、上下標、等號、不等號,只要無法直接在頁面上確認,就寫「□」,不可以憑數學常識或上下文補上。
8. 如果沒有收到講義內容,或內容無法處理,不要編造卡片,只輸出一個程式碼區塊:
=== 錯誤 ===
原因:(一句話)
用了 Skill 之後,每次只要貼來源標頭和 PDF,不用再貼提示詞:
【來源標頭】
科目:機率與統計
講義:(填講義編號)
頁碼範圍:(填這次要處理的印刷頁碼)
標記:不讀
今日總結
今天把機統 v1.4 和英文投影片 v1.2 包成一個 skill,並且測試了幾次,修改了兩個新版本,最後先停在 v3。
明日內容
明天做英文投影片的驗收,用 Skill 跑道德駭客還沒看過的 Module 02,發現的問題會和 SKILL.md 的改寫一起整理,把命令句改成說明原因,做成 Skill v4,順便觀察「評估可疑指令」和版權拒絕還會不會出現。